home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / ACORNUSERS / CBSA / GAMES / ZIP2000 / !Zip2000 / !Help < prev    next >
Text File  |  1998-08-04  |  35KB  |  805 lines

  1. Welcome to Zip 2000!
  2. ====================
  3.  
  4. Zip 2000 is a Standard interpreter (Revision 1.0) for Z-code programs.
  5.  
  6. In plain English, that means if you want to play Infocom interactive
  7. fiction, or games written with the Inform compiler, this is the program for
  8. you.
  9.  
  10. Features include:
  11.  
  12.   * Full support for Version 1,2,3,4,5,6,7 & 8 games.
  13.   * Full conformance to Graham Nelson's "Z-Machine Standards
  14.     Document", Revision 1.0.
  15.   * Graphics support.
  16.   * Colour support.
  17.   * Timed-input support.
  18.   * Sound support.
  19.   * Mouse support.
  20.   * Menu support.
  21.   * Full function key/cursor key/keypad support.
  22.   * Full foreign language support, including runes and Unicode.
  23.   * Easily adjustable screen size.
  24.   * Full use of anti-aliased outline fonts.
  25.   * Line editing & command recall.
  26.   * Quetzal-format save files.
  27.   * Partial Blorb support.
  28.   * Multiple UNDO.
  29.   * High speed - the fastest Z-code interpreter for RISC OS.
  30.   * The best-looking Z-code interpreter on any platform.
  31.  
  32.  
  33. What's Z-code?
  34. --------------
  35. In the dim and distant past, when one could buy more than one type of
  36. computer, a certain company that wished to produce interactive fiction
  37. wanted to come up with a portable game file that could be played on any
  38. number of microcomputers. So they invented an imaginary computer called the
  39. Z-machine, which ran an imaginary language called Z-code. They then compiled
  40. their games for this machine, and effectively wrote a Z-machine emulator for
  41. each computer they wished to support.
  42.  
  43. This program is a Z-machine emulator for RISC OS. With it you can play any
  44. Infocom game and games (or programs - the Z-machine isn't limited to games)
  45. produced with Graham Nelson's Z-code compiler "Inform".
  46.  
  47.  
  48. How do I play an Infocom/Inform game, then?
  49. -------------------------------------------
  50. First, find your story file. Infocom games are most readily available in the
  51. form of the "Lost Treasures of Infocom" packages. Buy the PC version, then
  52. copy the .DAT and .ZIP files (Version 1-5 games are usually .DAT, version 6
  53. games .ZIP) onto your hard disc (or a RISC OS floppy). Give them more
  54. sensible names, and set their type to "Z-Code". Then, just double-click on
  55. your chosen story file.
  56.  
  57. For Version 6 games (Arthur, Journey, Shogun, Zork Zero), you require the
  58. ".MG1" IBM graphics file. These may not have been included in the Lost
  59. Treasures packages, but the missing files are available from the IF-archive
  60. (see below). Give them the same name as their corresponding Z-code file, and
  61. place them in !Zip2000.Resources.Graphics. Alternatively the MG1 file can be
  62. renamed to "Graphics" and placed in the same directory as the Z-code file.
  63.  
  64. A number of Inform-produced games can be downloaded over the Internet.
  65. Undoubtedly the best source for all things interactive-fiction related, is
  66. Volker Blasius' IF-archive, at ftp.gmd.de. Two of the best freely- available
  67. games are "Curses" by Graham Nelson, and "Christminster" by Gareth Rees.
  68. Games are generally archived with the extensions ".z5", ".z8" etc. Download
  69. them, and set their type to "Z-Code". Then, double-click away.
  70.  
  71. Z-code programs were formerly given (unofficial) filetypes 061-068 (Z-Code1
  72. to Z-Code8) indicating which version they were. The extant versions are:
  73.  
  74.           Versions 1 & 2: Used by very early Infocom games. You
  75.                           probably won't find any of these. (I never
  76.                           have). Maximum file size of 128K.
  77.           Version 3:      Used by most Infocom games. Only supports
  78.                           simple text displays, with limited split-
  79.                           screen support.
  80.           Version 4:      Full support for split-screen operation,
  81.                           custom status lines and real-time input.
  82.                           Text effects (italic etc.) added.
  83.                           Maximum file size increased to 256K.
  84.           Version 5:      Added support for undo, colours, multiple
  85.                           fonts, real-time input, and the mouse.
  86.           Version 6:      Radically overhauled the screen model,
  87.                           adding multiple windows and graphics. Also
  88.                           increased the maximum file size to 512K.
  89.           Versions 7 & 8: Long after the death of Infocom, these were
  90.                           invented by Graham Nelson. They are exactly
  91.                           the same as Version 5, except internal
  92.                           changes allow larger game files. (512K in
  93.                           both cases). They are a way of creating
  94.                           large games that doesn't involve handling
  95.                           all the extra complexities of Version 6.
  96.  
  97. The old filetypes are now deprecated, as an official filetype (11A) has been
  98. allocated for Z-code programs. You can find out the version of a story file
  99. (regardless of its filetype) from Zip 2000's "About this file" dialogue box
  100. (see below).
  101.  
  102.  
  103. What do I do with a Blorb file?
  104. -------------------------------
  105. Blorb is a standard for packaging a Z-code story file together with its
  106. sound and graphical resources. On other platforms, Blorb files are given
  107. the extension ".blb". On RISC OS, the filetype should be set to Blorb (17B).
  108.  
  109. If the Blorb file contains the Z-code, you can just treat it as a standard
  110. story file, and double-click on it to start it. If a game has separate
  111. Z-code and story files, the Blorb file can be either:
  112.  
  113.    1) Called "Blorb", in the same directory as the Z-code file.
  114.    2) If the Z-code is "games.MyGame", the Blorb is "blorb.MyGame".
  115. or 3) Placed in !Zip2000.Resources.Blorb, with the same name as the Z-code
  116.       file.
  117.  
  118. These locations are searched in that order. If a Blorb file is found,
  119. Zip 2000 will not look anywhere else for its sound or graphics files.
  120.  
  121.  
  122. What widgets does Zip 2000 have?
  123. --------------------------------
  124. Well, for starters you can alter the screen size while running (except V6).
  125. This might cause some games to get a bit confused, as they may only check
  126. the screen size when loaded/restarted. I would suggest you find a screen
  127. size you like then use the Choices dialogue box to save it. The screen size
  128. for Version 6 is fixed at 80x25 characters.
  129.  
  130. You can also choose which fonts to use for display. Any text already on the
  131. screen may become wrongly aligned when you change font, but any new text
  132. will be OK. The font you choose as your "fixed-space" font _must_ be fixed
  133. space, or the screen display will go awry. Some odd fonts (such as
  134. System.Fixed) will not produce nice results, as they are somewhat
  135. differently aligned to most other fonts.
  136.  
  137. If you have a game that uses unusual accented characters, you should
  138. select an appropriate font, then select the correct alphabet from the
  139. Alphabet menu. Some fonts can provide a number of alphabets.
  140. Trinity.Medium, for example, provides Latin1, Latin2, Latin3 and Latin4.
  141. Others will provide a fixed alphabet - you should tell Zip 2000 what
  142. alphabet your font provides by selecting the appropriate alphabet.
  143.  
  144. I recommend that you turn on horizontal sub-pixel anti-aliasing up to 12pt
  145. in Configure for a higher quality display.
  146.  
  147. The window border can be turned on and off using the "Border" menu item on
  148. the Style menu.
  149.  
  150. The Choices dialogue box contains a number of options:
  151.      
  152.      Quick loading:    Don't pop up a "The story is loading" message
  153.                        while loading the file.
  154.                        
  155.      Pause on exit:    When a game quits, wait for a keypress before
  156.                        closing the window. You might find some games
  157.                        tend to print lots of text, then quit. Turn this
  158.                        on if you want a chance to read it.
  159.                        
  160.      Show caret...:    Normally the caret is only shown while inputting
  161.                        a line of text. Turn this on to also show the
  162.                        caret while waiting for a keypress. (Does not
  163.                        affect V6 games, which are able to turn the
  164.                        caret on and off themselves).
  165.                        
  166.      Confirm quitting: Ask if you really want to quit the game when
  167.                        you close the window.
  168.                        
  169.      Confirm           Ask if you really want to overwrite saved game
  170.      overwriting:      files or command script files.
  171.  
  172.      Smart quotes:     Try to turn the standard "sexless" quotes into
  173.                        open and close quotes intelligently, use
  174.                        fi and fl ligatures, and use em and en dashes
  175.                        where appropriate.
  176.                        
  177.      Interpreter Nº:   Some Infocom games behave differently depending
  178.                        on which machine they think they're running.
  179.                        This menu option allows you to change what
  180.                        Zip 2000 claims to be. Note that the games often
  181.                        only check this when restarted. For best results,
  182.                        I recommend keeping this set to 6 (IBM PC).
  183.                        
  184.      Consecutive UNDOs:This option allows you to choose how many times
  185.                        you wish to be able to UNDO in succession. Each
  186.                        available UNDO will take typically 30K of
  187.                        memory. If you change this option, it will not
  188.                        take effect until Zip 2000 is reloaded.
  189.                        
  190.                        Note that games created with Inform (as of
  191.                        version 6/7 of the library) do not allow
  192.                        multiple UNDOs, so this feature currently only
  193.                        works with Infocom games. Stefan Jokisch's
  194.                        Frotz gets around this by having an UNDO "hot
  195.                        key", but I believe that this affects game
  196.                        balance - a game may not wish UNDO to be
  197.                        available in certain situations (eg Beyond
  198.                        Zork during combat). Therefore you will
  199.                        have to wait for the Inform library to be
  200.                        updated.
  201.                        
  202.      Default colours:  Choose your default screen colours here.
  203.                        At the moment, this will usually not take
  204.                        effect until the game is restarted.
  205.                        
  206. The Save button saves these options, plus any options on the Style and
  207. Utilities menus.
  208.  
  209. Ah yes, the Utilities menu. This currently contains three options.
  210. "Claim F12" sets whether Zip 2000 claims F12 and passes it to the game, or
  211. ignores it and lets the Wimp bring up the command line.
  212.  
  213. "Line editing" enables the line editing feature - you can use the left and
  214. right cursor keys to move the cursor within the line. If this option is
  215. enabled, the game will not receive the left and right cursor keys if they
  216. are pressed during line input. This should not normally be a problem.
  217.  
  218. The line editing keys Zip 2000 responds to with line-editing enabled are:
  219.  
  220.      Left, Right, Shift-Left, Shift-Right, Ctrl-Left, Ctrl-Right,
  221.      Delete, Backspace, Copy/End, Ctrl-Copy/End, Ctrl-U
  222.  
  223. With line-editing disabled, you can only use:
  224.  
  225.      Delete, Backspace, Ctrl-U
  226.  
  227. "Command recall" enables the command recall feature - use the up and down
  228. cursor keys to recall previous lines of input. If enabled, the game will not
  229. receive the up and down cursor keys if they are pressed during line input.
  230. This might cause a problem in some games - Beyond Zork being a case in
  231. point.
  232.  
  233. "Keypad functions" selects whether the numeric keypad is used for
  234. number entry or as a set of special "function keys". In some games,
  235. for example Beyond Zork, the keypad can be used to move you around if
  236. this option is enabled.
  237.  
  238. The "About this file" dialogue box is slightly unorthodox. It shows
  239. the release number and serial number of a game file, plus its Z-code
  240. version. The file size displayed is that reported in the file's header -
  241. not the space it actually occupies on disc.
  242.  
  243.  
  244. Where do saved files go?
  245. ------------------------
  246. First, saved game files are stored in !Zip2000.Resources.SavedGames,
  247. if you just type a leafname. You can type a full pathname to put it
  248. elsewhere. Future versions may incorporate drag & drop saving, but
  249. personally I think it's easier just to type in a filename while playing
  250. a text adventure. This default location can be altered in Zip 2000's
  251. !Run file; if you are a floppy-disc user you may want to set
  252. ZipSave$Path to ADFS::$.0.
  253.  
  254. Secondly, transcript and record files are, by default, stored in the
  255. same directory as !Zip2000.
  256.  
  257. Thirdly, auxiliary files saved by games are stored in
  258. !Zip2000.Resources.Files. (If a game wants to save a file PLAYER.AUX
  259. it will be saved as !Zip2000.Resources.AUX.PLAYER).
  260.  
  261.  
  262. You mentioned sound support. How does this work?
  263. ------------------------------------------------
  264. Well, currently there are only two games that support sound: The Lurking
  265. Horror, and Sherlock. Here I will explain how to play The Lurking Horror
  266. with sound.
  267.  
  268. Buy Lost Treasures of Infocom I (PC version), then download Stefan Jokisch's
  269. archive of Lurking Horror sounds from ftp.gmd.de. Create a "Lurking"
  270. directory in !Zip2000.Resources.Sounds, and copy Stefan's sound files
  271. (LURKINnn/SND) into this directory.
  272.  
  273. Next, you will need to convert your PC release 203 Lurking Horror into
  274. Release 221 (the Amiga version). Stefan supplies a program to do this, but
  275. it's a PC one. I have recompiled it for RISC OS, and you will find it in the
  276. Utilities directory. Use it to update your story file, as Stefan explains.
  277. And that's all there is to it. When you run The Lurking Horror, you will now
  278. be scared out of your wits.
  279.  
  280. The procedure for Sherlock is similar; again the conversion program is in
  281. the Utilities directory.
  282.  
  283. Technical stuff
  284. ~~~~~~~~~~~~~~~
  285. In general, if a game tries to play sound n, Zip 2000 will look in
  286. Resources.Sounds for a directory with the same name as the game file. If it
  287. doesn't find one, it will look for a directory "Sounds" in the same
  288. directory as the game file. It will then look in that directory for the file
  289. "ssssssnn/SND", where ssssss is the first six characters of the story file's
  290. leafname, and nn is the number of the sample (padded to 2 digits). So
  291. Sherlock's sounds might be stored as "SHERLO03/SND" upwards. The files
  292. should be Macintosh format ".DAT" files, as archived at ftp.gmd.de by Stefan
  293. Jokisch.
  294.  
  295.  
  296. You mentioned mouse support. How does this work?
  297. ------------------------------------------------
  298. You click on the window. This will only work if a game states that it wants
  299. to use the mouse in its header. The only games that I know of that use the
  300. mouse are Beyond Zork, Zork Zero, Shogun, Journey, Arthur, and my own
  301. SameGame.
  302.  
  303.  
  304. I notice that Zip 2000 puts the full title of a
  305. game into it's title bar. How do they do that?
  306. ----------------------------------------------
  307. By cheating. The file !Zip2000.Messages contains a full list of all known
  308. Infocom games, plus some Inform ones, matching release/version numbers (as
  309. shown by the About this File box) to full names. You may feel free to add
  310. new games to this file. A proposal is on the table to store this
  311. information in Blorb files.
  312.  
  313.  
  314. Version 6 notes
  315. ---------------
  316. The original Infocom games' graphics frequently use colours not well
  317. approximated by RISC OS' default 256-colour palette. Therefore for best
  318. effect, you should ideally play in a 32 thousand colour mode.
  319.  
  320. Note that Version 6 games run a LOT faster on a RISC OS 3.6 machine, as the
  321. RISC OS 3.6 version of SpriteExtend can custom-assemble much faster sprite
  322. plotting routines (typically three times faster than RISC OS 3.5).
  323.  
  324. A few visual glitches occur in Zork Zero and Journey. This the result of
  325. Infocom not properly taking account of the effects of proportional fonts 
  326. (eg measuring the width of a string to centre it, but switching to bold
  327. _after_ it's measured it, because it assumes a piece of bold text is the
  328. same length as the same text in roman). Other mistakes are probably mine.
  329.  
  330. The screen bitmap is stored either as a 640x200 or 640x400 sprite, depending
  331. on the current screen mode when Zip 2000 is loaded. This does not change
  332. until Zip 2000 is reloaded, so if you change from a square pixel mode to a
  333. rectangular pixel mode (or vice versa) you should start Zip 2000 again.
  334.  
  335. Zip 2000 is not bright enough to turn off the border if you start a Version
  336. 6 game in a 640x480 mode, so you will lose part of the display. You can turn
  337. it off manually (and save this choice if you wish).
  338.  
  339.  
  340. What standards does Zip 2000 conform to?
  341. ----------------------------------------
  342. 1) Zip 2000 aims to be an accurate Z-machine implementation, as per
  343.    the Z-Machine Standards Document, Version 1.0.
  344.  
  345.    To support Unicode characters, Zip 2000 will allow you to select
  346.    a font + an "alphabet" setting. The alphabet selects a mapping
  347.    table, to tell Zip 2000 what Unicode characters &80-&FF in the
  348.    font correspond to. (&00-&7F are assumed to correspond to ASCII/
  349.    ZSCII/Unicode characters &00-&7F). Some RISC OS fonts, such as
  350.    Trinity.Medium, can provide multiple alphabets, and will switch
  351.    as you change the alphabet setting. Others provide only one
  352.    alphabet, so you must select the correct alphabet to tell
  353.    Zip 2000 what that alphabet is.
  354.  
  355.    To teach Zip 2000 about a new alphabet, just create a mapping
  356.    file and place it in !Zip2000.Resources.Encodings.
  357.  
  358.    Zip 2000 is not capable of handling bidirectional text,
  359.    combining characters, or languages with unusual formatting
  360.    rules.
  361.  
  362. 2) Zip 2000's save files are in the standard Quetzal format. This
  363.    means you can transfer your saved positions to and from other
  364.    Quetzal-supporting interpreters. Previous versions of Zip 2000
  365.    used two other formats (an uncompressed format from version 1.00 to
  366.    1.14, and a Frotz-like compressed format from 1.15 to 1.29). This
  367.    version will still load these, but be aware that when you save
  368.    again, the resulting Quetzal file will not quite be correct - a
  369.    different interpreter may not be able to load it.
  370.  
  371. 3) A new format for packaging sound and graphics for Z-code programs
  372.    has been defined, called Blorb. Zip 2000 only partially supports
  373.    this format - only AIFF sound chunks work in any useful fashion. 
  374.    In the interim, Zip 2000 understands Infocom Macintosh sound files
  375.    and Infocom IBM .MG1 graphics files, as described above.
  376.  
  377.  
  378.  
  379. How much do I pay you for this wondrous program?
  380. ------------------------------------------------
  381. Nothing, unless you particularly want to. Zip 2000 is freeware.
  382.  
  383.      
  384. So, like, what's the history of this thing?
  385. -------------------------------------------
  386.  
  387. Version 1.00 (17-Nov-95)
  388. ~~~~~~~~~~~~~~~~~~~~~~~~
  389. First public release. Conformance to Graham Nelson's proposed
  390. Standard 0.2 (15-Nov-95).
  391.  
  392. Version 1.01 (20-Nov-95)
  393. ~~~~~~~~~~~~~~~~~~~~~~~~
  394. New features:
  395.   File size now extracted from header.
  396. Bugs fixed:
  397.   When the screen size was changed, the game wasn't told.
  398.   When games exited, anything printed since the last new-line
  399.   wasn't displayed.
  400. Conformance improvements:
  401.   random 0 (randomise RNG) was not implemented
  402.   All sorts of screen handling stuff fixed, in particular:
  403.      Buffering in upper window on V4 and earlier.
  404.      Initial cursor position in V4 and earlier.
  405.      Character wrapping when buffering off.
  406.      Style changes in upper window being passed to lower.
  407.      erase_window -1 & -2 sorted out.
  408.   The illegal command @sound_effect (no parameters) caused
  409.   a crash. It now simply beeps.
  410.  
  411. Version 1.02 (22-Nov-95)
  412. ~~~~~~~~~~~~~~~~~~~~~~~~
  413. New features:
  414.   You can now choose whether the caret is displayed while waiting
  415.   for a character.
  416.   Function keys F1-F11 now always claimed - F12 is toggleable.
  417.   Quitting behaviour overhauled.
  418.   [REG] Command recall part of line editing implemented.
  419.   [REG] Smart quotes, ligatures and dashes.
  420. Conformance improvements:
  421.   Accented characters are now correctly lower-cased when put
  422.   into input buffer.
  423.   Backspace now returned from read_char (this was an omission
  424.   from revision 0.2 of the Standard).
  425.   Foreign quotes (« and ») swapped - a mistake in revision 0.2.
  426.   Interrupt routines were being called with the timeout
  427.   as a parameter.
  428.   Return is now passed to the game as code 13, rather than 10 -
  429.   this is required by Bureaucracy.
  430.  
  431. Version 1.03 (23-Nov-95)
  432. ~~~~~~~~~~~~~~~~~~~~~~~~
  433. Bugs fixed:
  434.   Memory was often lost when a game using sound was quit.
  435.   Repeated sounds didn't work properly in V5.
  436. Conformance improvements:
  437.   Sound callback routines implemented - Sherlock's sounds now
  438.   operate correctly.
  439.   Delete input code changed from 8 to 127.
  440.  
  441. Version 1.04 (27-Nov-95)
  442. ~~~~~~~~~~~~~~~~~~~~~~~~
  443. New features:
  444.   Sound data now stored in a dynamic area, rather than the
  445.   module area.
  446.   Official filetype allocated.
  447.   [REG] Selectable fonts.
  448.   Paging system removed to speed up interpretation (it was broken
  449.   anyway). Various other optimisations made.
  450. Bugs fixed:
  451.   The save opcode was not correctly implemented in V4 - it was
  452.   not possible to save on many V4 games.
  453.   Text was often a couple of pixels out of line in upper window.
  454.   Some upper window flicker removed.
  455.   Nasty memory corruption fixed - printing a complicated line of
  456.   text (lots of style changes) would mangle the game's dictionary
  457.   (if you were lucky).
  458.   The size of a Version 7 game was wrongly read from the header
  459.   for the purposes of the verify opcode, and in a number of other
  460.   places (although note that Inform 5.5 also puts the wrong size
  461.   in the header - these bugs would cancel each other out for
  462.   V7 games less than 256K).
  463. Conformance improvements:
  464.   The return value of the read opcode was -1 (rather than 0) if it
  465.   was terminated by a time-out.
  466.   The nop opcode was not implemented (!).
  467.   The get_cursor opcode was not implemented.
  468.   Trapped divide by zero errors nicely.
  469.   Now more rigorous trapping writes outside the dynamic area.
  470.   Tokeniser revised - it was being over-clever.
  471.   [MORE] prompts improved.
  472.   set_font 0 wasn't implemented.
  473.   Alternate alphabets can now be changed at run-time.
  474.   Fourth parameter of print_table was not implemented.
  475.   Characters 0 and 13 in text did not behave as specified.
  476.   Mouse position was only updated on clicks. It should now be
  477.   possible to write a doodling program (!).
  478.  
  479. Version 1.05 (28-Nov-95)
  480. ~~~~~~~~~~~~~~~~~~~~~~~~
  481. New features:
  482.   Prototype (text-only) version 6 support. Sufficient to get Zork Zero
  483.   going in a basic sort of fashion.
  484.  
  485. Version 1.06 (30-Nov-95)
  486. ~~~~~~~~~~~~~~~~~~~~~~~~
  487. Bugs fixed:
  488.   Version 3 games didn't take account of the status line when deciding
  489.   when to print "[MORE]".
  490.   Beeps made slightly quieter (they were somewhat louder than the
  491.   standard VDU 7 beep).
  492.   Game file no longer kept open while playing.
  493. Conformance improvements:
  494.   Mid-line font changes, and changes of the fixed-space header bit
  495.   handled better. This includes a major word-wrapping overhaul.
  496.   Output stream 1 couldn't be turned on and off in mid-line.
  497.   [This trick is used at the start of Zork Zero so that the initial
  498.   letter A is a fancy graphic on screen, but output as normal to
  499.   a transcript. Interestingly, though, Infocom's IBM interpreter
  500.   also gets this wrong.]
  501.  
  502. Version 1.10 (13-Dec-95)
  503. ~~~~~~~~~~~~~~~~~~~~~~~~
  504. New features:
  505.   Full Version 6 support, including graphics and menus.
  506.   Word-wrapping wraps on hyphens.
  507.   Performance improvement by removing unnecessary 16-bitness.
  508.   [REG] Can choose what type of computer Zip 2000 claims to be.
  509.   Sound files split into directories inside Resources.Sounds. Will also look
  510.   for sounds in a "Sounds" directory alongside the game file.
  511.   Window border can be turned on and off.
  512.   [REG] Default text colours selectable.
  513. Bugs fixed:
  514.   READ_MOUSE slightly corrupted memory.
  515.   Couldn't transcript to "RAM:Fred".
  516.   Various problems with the caret fixed. For example, Zip 2000 wouldn't
  517.   let the input focus escape while you were playing Freefall.
  518.   Error handling improved.
  519.   The window will be forced to a suitable size for the current
  520.   screen mode when Zip 2000 is loaded.
  521. Conformance improvements:
  522.   Mouse buttons weren't handled correctly.
  523.   Slight end-of-paragraph wordwrapping glitch fixed.
  524.   Two changes following a newsletter distributed by Graham Nelson:
  525.      Version 7 respecified - V7 games produced with Inform 5.5
  526.      will no longer be playable.
  527.      Some foreign characters added (OE ligatures, plus Spanish
  528.      inverted ? and !).
  529.   Accented characters sometimes incorrectly terminated a line of input.
  530.     
  531. Version 1.11 (18-Dec-95)
  532. ~~~~~~~~~~~~~~~~~~~~~~~~
  533. New features:
  534.   Another slight performance improvement by removing unnecessary
  535.   16-bitness.
  536. Bugs fixed:
  537.   The primary colours were in the wrong order in V6.
  538.   Font 3 (runes and character graphics) came out half-height in a high-
  539.   resolution mode in V6.
  540.   Newlines due to a character wrap weren't sent to the transcript.
  541. Conformance improvements:
  542.   ERASE_PICTURE wasn't implemented.
  543.   SCROLL_WINDOW with a negative number of pixels wasn't implemented.
  544.   The line count wasn't reset to zero when a window was cleared (so
  545.   it would say [MORE] too early).
  546.   The line count wasn't incremented on a character wrap (so it
  547.   would say [MORE] too late).
  548.   Byte-sized properties weren't implemented in V4+ - this may have
  549.   affected Shogun, Journey and Zork Zero (they were never used by
  550.   Infocom in V4/5 and aren't used by Inform).
  551.   Journey had problems with its menus due to COPY_TABLE not working in
  552.   the way it expected. A temporary fix has been made until the correct
  553.   behaviour in V6 has been investigated. (If you found yourself stuck
  554.   at the river with a choice of "Return", "Return", or "Return", this
  555.   is why).
  556.   
  557. Version 1.12 (20-Dec-95)
  558. ~~~~~~~~~~~~~~~~~~~~~~~~
  559. Bugs fixed:
  560.   Buffer wasn't flushed before output redirection enabled. This
  561.   mis-aligned Zork Zero's function key definitions screen.
  562.   Lines sometimes character-wrapped instead of word-wrapping
  563.   (character wrapping occurred 1 pixel before word wrapping).
  564.  
  565. Version 1.15 (15-Jan-96)
  566. ~~~~~~~~~~~~~~~~~~~~~~~~
  567. New features:
  568.   More efficiency improvements.
  569.   Saved games are now compressed (they're now typically 10 times smaller).
  570.   Graphics rendering approx 450% faster, thanks to more intelligent
  571.   use of the PICTURE_TABLE opcode.
  572.   Multiple UNDO.
  573.   Line input vastly improved: line editing implemented, V6 editing
  574.   much tidier, now limited to window width.
  575.   "Line editing" option split into "Line editing" and "Command recall".
  576.   "Confirm overwriting" option added.
  577.   "Smart quotes" option added.
  578.   You can press Escape to cancel a load/save.
  579.   You now get a friendly message if you attempt to load a saved game
  580.   belonging to another game.
  581.   "The story is loading..." message restored to V6 games.
  582.   Main window regains the input focus after you've finished with the
  583.   choices dialogue box.
  584. Bugs fixed:
  585.   Character wrap problem in V6 totally eradicated.
  586.   Sound crashes fixed.
  587.   Zork Zero's map of Antharia would kill Zip 2000 (it couldn't cope
  588.   with cacheing a picture twice).
  589. Conformance improvements:
  590.   Behaviour of COPY_TABLE revised for all versions.
  591.   Input buffer was incorrectly terminated by a zero-byte in V5+;
  592.   TOKENISE could not cope with an unterminated text buffer
  593.   in V5+ - this affected Journey.
  594.   A number of small problems with input routines fixed.
  595.   Recording, scripting and playback improved. Command script files
  596.   now store timeout information, terminating characters and mouse
  597.   co-ordinates.
  598.   SOUND_EFFECT 2 now low-pitched instead of high-pitched.
  599.   DRAW_PICTURE now takes co-ordinates as signed (the view from
  600.   the top of the Sunset Tower in Journey did not appear because
  601.   of this).
  602.   Handling of header over restores and restarts made more
  603.   rigorous.
  604.   Input line now redrawn if a timeout routine prints something.
  605.   
  606. Version 1.16 (15-Jan-96)
  607. ~~~~~~~~~~~~~~~~~~~~~~~~
  608. New features:
  609.   Tokeniser made more efficient (code borrowed from Frotz).
  610.   [MORE] prompt appears 1 line earlier after a READ, to stop your
  611.   line of input disappearing off the top of the screen.
  612. Bugs fixed:
  613.   The "new improved" command replaying didn't work properly.
  614.   Replayed commands with terminating characters did not display
  615.   correctly.
  616.   Replayed commands had a spurious newline after them.
  617.   V6 smart quotes were broken in version 1.15.
  618.   
  619. Version 1.17 (18-Jan-96)
  620. ~~~~~~~~~~~~~~~~~~~~~~~~
  621. New features:
  622.   Large overhaul of the Z-machine "CPU". It is now almost totally
  623.   32-bit internally, resulting in far more effective use of the ARM.
  624.   In a quick benchmark, a prime-finding routine that took 3 minutes
  625.   13 seconds in Zip 2000 v1.00 now takes 1 minute 30 seconds. (This
  626.   also shaved 3½K of code off v1.16).
  627. Bugs fixed:
  628.   Newlines printed while buffering was off didn't increment the
  629.   line counter. Line counts after a READ tweaked again.
  630.  
  631. Version 1.18 (23-Jan-96)
  632. ~~~~~~~~~~~~~~~~~~~~~~~~
  633. Conformance improvements:
  634.   INPUT_STREAM 0 wasn't implemented.
  635. Bugs fixed:
  636.   Confirm overwriting didn't work properly.
  637.   If command recall was used during a filename prompt, Zip 2000 would
  638.   crash.
  639.   Zip 2000 now crashes somewhat more gently(!)
  640.  
  641. Version 1.19 (28-Jan-96)
  642. ~~~~~~~~~~~~~~~~~~~~~~~~
  643. Bugs fixed:
  644.   Used to abort with a "Buffer too short." error when run on a machine
  645.   with Doggysoft's "NewerLook" installed.
  646.   The last word separator (usually " in Infocom games) was not picked
  647.   up.
  648.  
  649. Version 1.20 (10-Mar-96)
  650. ~~~~~~~~~~~~~~~~~~~~~~~~
  651. General improvements:
  652.   Memory usage reduced for non-V6 games.
  653.   The game data and stack now placed in a dynamic area (primarily to aid
  654.   the experimental Infix debugger).
  655.   Central instruction dispatcher hand-crafted in assembler for speed (the
  656.   aforementioned speed benchmark now takes 1 minute 10 seconds).
  657. Bugs fixed:
  658.   If you had one of Zip 2000's menus up when you quit Zip 2000 (by typing
  659.   QUIT in the game), the desktop would collapse. This is thanks to a bug
  660.   in the current version of the Toolbox. Menus are now closed just before
  661.   quitting, as a work-around.
  662.   Doesn't reset the current sound voice to WaveSynth-Beep after playing
  663.   a sound effect.
  664.  
  665. Version 1.21 (20-Mar-96)
  666. ~~~~~~~~~~~~~~~~~~~~~~~~
  667. New features:
  668.   Font 3 not loaded until required.
  669. Conformance improvements:
  670.   Text margins are no longer reset when a window was cleared.
  671.   Cursor now confined within margins when using SET_CURSOR.
  672. Bugs fixed:
  673.   PICTURE_DATA now responds correctly when asked about a
  674.   non-existent picture.
  675.   Now copes correctly with text windows that are not a whole number
  676.   of lines high (eg in Shogun while exploring Osaka).
  677.   V6 text width measurements were broken for anything other than
  678.   Roman text.
  679.   The last space of a line would sometimes overflow the right margin.
  680.   
  681. Version 1.22 (03-Apr-96)
  682. ~~~~~~~~~~~~~~~~~~~~~~~~
  683. Bugs fixed:
  684.   RESTART didn't work properly in version 1.21.
  685.  
  686. Version 1.23 (03-Oct-96)
  687. ~~~~~~~~~~~~~~~~~~~~~~~~
  688. New feature:
  689.   Keypad can now be made to act normally, instead of being treated
  690.   specially.
  691.  
  692. Version 1.24 (29-Aug-97)
  693. ~~~~~~~~~~~~~~~~~~~~~~~~
  694. Bug fixed:
  695.   Beyond Zork used to crash nastily at a certain point (no
  696.   spoilers here.) This crept in in version 1.17, and is, strictly
  697.   speaking, a bug in Beyond Zork. Now worked around.
  698.  
  699. Version 1.25 (20-Oct-97)
  700. ~~~~~~~~~~~~~~~~~~~~~~~~
  701. Bugs fixed:
  702.   Didn't act on Message_PaletteChanged.
  703.   Keeps clear of the icon bar when opening windows.
  704.  
  705. Version 1.30 (22-Jul-98)
  706. ~~~~~~~~~~~~~~~~~~~~~~~~
  707. Conformance improvements:
  708.   Updated to version 1.0 of the Z-Machine Standards Document.
  709.   Now saves and loads Quetzal-format save files.
  710. New features:
  711.   Selectable alphabets.
  712.   Released as freeware.
  713. General improvements:
  714.   Much stricter regulation of memory accesses - never used to
  715.   fault writes outside dynamic memory, for example.
  716.  
  717. Version 1.31 (04-Aug-98)
  718. ~~~~~~~~~~~~~~~~~~~~~~~~
  719. Conformance improvements:
  720.   Will play Blorb story files. Currently only supports AIFF
  721.   sounds. Will show boxes for PNG graphics.
  722.   RANDOM -n (for n < 1000) now seeds the random number generator
  723.   as suggested in the Standard.
  724.   Screen model for V6 shaken up - screen is now 640x400 Z-pixels;
  725.   this makes more sense for Blorb graphics games.
  726.   GET_PROP_LEN 0 now returns 0. Shogun seems to require this.
  727. Bug fixes:
  728.   Any Unicode characters outside the Latin-1 range would get
  729.   garbled if printed in the upper window.
  730.   Data aborts, etc, were bringing up a garbled error message.
  731. General improvements:
  732.   File information dialogue box extended to show Blorb auxiliary
  733.   information.
  734.   Default choices tweaked slightly.
  735.  
  736.  
  737. Own up, who helped you with it?
  738. -------------------------------
  739. Well, by far the largest credit goes to Mark Howell, on whose Zip
  740. interpreter core this program is based. Many thanks, Mark.
  741.  
  742. Graham Nelson made lots of encouraging noises as I sent him two new
  743. versions a day during early development. He also suggested all sorts
  744. of features, some of which have actually been implemented already,
  745. and wrote the excellent Z-machine Standards Document to which
  746. Zip 2000 conforms (all 81 pages of it!). He also writes great test
  747. files! (Advert: Download your copy of Jigsaw today).
  748.  
  749. Stefan Jokisch provided help with the sound support, and guided
  750. me through the Zip source. His list of Zip bugs was most helpful,
  751. inspiring many of the changes in versions 1.04 and 1.06. Versions
  752. 1.15 onwards have borrowed many ideas (and some code!) from his
  753. Frotz interpreter.
  754.  
  755. Philip Banks wrote the excellent DataVox module that Zip 2000
  756. uses to play sound effects.
  757.  
  758. The Quetzal save file format was created by Martin Frost.
  759.  
  760. The Blorb resource format was created by Andrew Plotkin.
  761.  
  762.  
  763. Are there any bugs^H^H^H^H unexpected features?
  764. -----------------------------------------------
  765. If you play Beyond Zork, with a non-standard colour set (eg white
  766. on blue), on a machine with RISC OS 3.5, in a 32-thousand colour
  767. mode, you will notice that the character graphics' colours don't
  768. match. This is a limitation of RISC OS 3.5 (not a bug). I could
  769. work around it, but it's probably not worth the trouble.
  770. RISC OS 3.6 is fine.
  771.  
  772. The colour selection in the Choices dialogue box will generally
  773. not take effect until the game is restarted.
  774.  
  775. Adjust-clicking on a game-created menu will not always do quite
  776. what it should. I can assure you there is a very good technical
  777. reason for this. I've thought of a work-around, and will
  778. implement it in a future version.
  779.  
  780. Changing the font may cause the current input line to become
  781. a little confused. This will be cured when you press Return.
  782.  
  783. Smart dashes don't work as well in V6 as in other versions.
  784.  
  785.  
  786. And where can I contact you when I find more "features"?
  787. --------------------------------------------------------
  788. My e-mail address is kbracey@acorn.co.uk.
  789.  
  790. My physical location is:     Kevin Bracey,
  791.                              90 Sleaford Street,
  792.                              CAMBRIDGE
  793.                              CB1 2PU
  794.  
  795. Please, please, please, please, _please_, let me know of any bugs you find,
  796. or any suggestions you have for future versions.
  797.  
  798.  
  799. Licence arrangements
  800. --------------------
  801. Zip 2000 is Copyright 1998, Kevin Bracey. It may be freely distributed,
  802. providing you distribute the whole application directory unaltered, including
  803. this file.
  804.  
  805.